home *** CD-ROM | disk | FTP | other *** search
/ CD Ware Multimedia 1998 February / CD WARE MULTIMEDIA (02-1998) CD++.iso / Encript / SNOW / SNOW.DOC next >
Encoding:
Text File  |  1997-01-08  |  4.7 KB  |  123 lines
  1.  
  2. SNOW(1)                                                   SNOW(1)
  3.  
  4.  
  5. NAME
  6.        snow - whitespace steganography program
  7.  
  8. SYNOPSIS
  9.        snow [ -CQS ] [ -p passwd ] [ -l line-len ] [ -f file | -m
  10.        message ] [ infile [ outfile ]]
  11.  
  12. DESCRIPTION
  13.        snow is a program for concealing messages in text files by
  14.        appending  tabs  and  spaces  on the end of lines, and for
  15.        extracting messages from files containing hidden messages.
  16.        Tabs  and spaces are invisible to most text viewers, hence
  17.        the steganographic nature of this encoding scheme.
  18.  
  19.        The data is  concealed  in  the  text  file  by  appending
  20.        sequences  of up to 7 spaces, interspersed with tabs. This
  21.        usually allows 3 bits to be stored  every  8  columns.  An
  22.        alternative  encoding scheme, using alternating spaces and
  23.        tabs to represent zeroes and ones, was  rejected  because,
  24.        although it used fewer bytes, it required more columns per
  25.        bit (4.5 vs 2.67).
  26.  
  27.        The start of the data is  indicated  by  an  appended  tab
  28.        character,  which  allows  the  insertion of mail and news
  29.        headers without corrupting the data.
  30.  
  31.        snow  provides  rudimentary  compression,  using   Huffman
  32.        tables optimised for English text. However, if the data is
  33.        not text, or if there is a lot of data,  the  use  of  the
  34.        built-in compression is not recommended, since an external
  35.        compression program such as compress or  gzip  will  do  a
  36.        much better job.
  37.  
  38.        Encryption  is  also  provided,  using  the ICE encryption
  39.        algorithm in 1-bit cipher-feedback (CFB) mode. Because  of
  40.        ICE's  arbitrary  key  size, passwords of any length up to
  41.        1170 characters are supported (since only 7 bits  of  each
  42.        character  are used, keys up to 1024-bytes are supported).
  43.  
  44.        If a message string or message file are specified  on  the
  45.        command-line,  snow will attempt to conceal the message in
  46.        the file infile if specified, or standard input otherwise.
  47.        The  resulting  file  will be written to outfile if speci-
  48.        fied, or standard output if not.
  49.  
  50.        If no message string is provided, snow attempts to extract
  51.        a  message  from  the input file. The result is written to
  52.        the output file or standard output.
  53.  
  54. OPTIONS
  55.        -C     Compress the data if concealing, or  uncompress  it
  56.               if extracting.
  57.  
  58.        -Q     Quiet   mode.  If  not  set,  the  program  reports
  59.               statistics  such  as  compression  percentages  and
  60.               amount of available storage space used.
  61.  
  62.        -S     Report on the approximate amount of space available
  63.               for hidden message in the text file. Line length is
  64.               taken  into account, but other options are ignored.
  65.  
  66.        -p password
  67.               If this is set, the data  will  be  encrypted  with
  68.               this password during concealment, or decrypted dur-
  69.               ing extraction.
  70.  
  71.        -l line-len
  72.               When appending whitespace, snow will always produce
  73.               lines shorter than this value. By default it is set
  74.               to 80.
  75.  
  76.        -f message-file
  77.               The contents of this file will be concealed in  the
  78.               input text file.
  79.  
  80.        -m message-string
  81.               The  contents  of  this string will be concealed in
  82.               the input text file.  Note that, unless  a  newline
  83.               is  somehow  included in the string, a newline will
  84.               not be printed when the message is extracted.
  85.  
  86. EXAMPLES
  87.        The following command  will  conceal  the  message  "I  am
  88.        lying" in the file infile, with compression, and encrypted
  89.        with the password "hello world". The resulting  text  will
  90.        be stored in outfile.
  91.  
  92.               snow  -C  -m  "I  am lying" -p "hello world" infile
  93.               outfile
  94.  
  95.        To extract the message, the command would be
  96.  
  97.               snow -C -p "hello world" outfile
  98.  
  99.        Note that the resulting message will not be terminated  by
  100.        a newline.
  101.  
  102.        To  prevent line wrap if text with concealed whitespace is
  103.        likely to be indented by mail  or  news  readers,  a  line
  104.        length of 72 or less can be used.
  105.  
  106.               snow -C -l 72 -m "I am lying" infile outfile
  107.  
  108.        The  approximate  storage capacity of a file can be deter-
  109.        mined with the -S option.
  110.  
  111.               snow -S -l 72 infile
  112.  
  113.  
  114. AUTHOR
  115.        This application was written by Matthew Kwan, who can usu-
  116.        ally be reached at mkwan@cs.mu.oz.au
  117.  
  118. SEE ALSO
  119.        ice_key_create(3)
  120.  
  121.  
  122. Version 1.1                28 Dec 1996                          1
  123.